initd-foreverでNode.jsアプリをデーモン化する
ども、大瀧です。
最近Node.jsで作ったアプリをシステム起動時に自動起動させることが良くあるのですが、/etc/rc.localにnode <SCRIPT_NAME>と直書きするのも使い勝手が良くないかなと思い、foreverとSysVinitを連携させるinitd-foreverというツールを試してみたのでレポートします。
initd-foreverとは
Node.jsのプロセスマネージャーとしてはforeverが著名ですが、Linuxの枯れたシステム管理サービスのSysVinitからforeverをキックするスクリプトを生成するのがinitd-foreverです。foreverと同じく、npmでインストールします。
$ npm install -g forever initd-forever npm WARN optional dep failed, continuing [email protected] /home/vagrant/.nvm/versions/node/v0.12.9/bin/initd-forever -> /home/vagrant/.nvm/versions/node/v0.12.9/lib/node_modules/initd-forever/bin/initd-forever.js /home/vagrant/.nvm/versions/node/v0.12.9/bin/forever -> /home/vagrant/.nvm/versions/node/v0.12.9/lib/node_modules/forever/bin/forever [email protected] /home/vagrant/.nvm/versions/node/v0.12.9/lib/node_modules/initd-forever ├── [email protected] ├── [email protected] └── [email protected] ([email protected], [email protected]) [email protected] /home/vagrant/.nvm/versions/node/v0.12.9/lib/node_modules/forever ├── [email protected] ├── [email protected] ├── [email protected] ├── [email protected] ├── [email protected] ├── [email protected] ([email protected], [email protected]) ├── [email protected] ([email protected], [email protected]) ├── [email protected] ([email protected], [email protected]) ├── [email protected] ([email protected], [email protected]) ├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected]) ├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected]) ├── [email protected] ([email protected], [email protected], [email protected]) ├── [email protected] ([email protected], [email protected]) ├── [email protected] ([email protected], [email protected], [email protected], [email protected]) └── [email protected] ([email protected], [email protected], [email protected], [email protected]) $
initd-foreverコマンドで実行します。まずは--helpオプションでヘルプを見てみましょう。
$ initd-forever --help
Usage: initd-forever [options]
Options:
-h, --help output usage information
-V, --version output the version number
-a, --app [path] Path to node.js main file
-c, --command [value] Command to execute on main file
-e, --env [value] Export NODE_ENV with value
-l, --logfile [path] Logs the daemon output to LOGFILE
-n, --name [value] Application name
-p, --pidfile [path] The pid file
-m, --monit [value] Generate the monit script file with the listen port number
-f, --forever [value] The location of forever
$
foreverのオプションと同じような項目が並んでいますね。サンプル/home/vagrant/index.jsを用意して、スクリプトを生成してみます。
$ initd-forever -a /home/vagrant/index.js -n samplenode Script daemon file saved to samplenode $ ls index.js samplenode $
カレントディレクトリに、-nで指定したサービス名のスクリプトが生成されました。中身はこんな感じです。
#!/bin/bash
### BEGIN INIT INFO
# If you wish the Daemon to be lauched at boot / stopped at shutdown :
#
# On Debian-based distributions:
# INSTALL : update-rc.d scriptname defaults
# (UNINSTALL : update-rc.d -f scriptname remove)
#
# On RedHat-based distributions (CentOS, OpenSUSE...):
# INSTALL : chkconfig --level 35 scriptname on
# (UNINSTALL : chkconfig --level 35 scriptname off)
#
# chkconfig: 2345 90 60
# Provides: /home/vagrant/index.js
# Required-Start: $remote_fs $syslog
# Required-Stop: $remote_fs $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: forever running /home/vagrant/index.js
# Description: /home/vagrant/index.js
### END INIT INFO
#
# initd a node app
# Based on a script posted by https://gist.github.com/jinze at https://gist.github.com/3748766
#
if [ -e /lib/lsb/init-functions ]; then
# LSB source function library.
. /lib/lsb/init-functions
fi;
pidFile="/var/run/samplenode.pid"
logFile="/var/run/samplenode.log"
command="node"
nodeApp="/home/vagrant/index.js"
foreverApp="forever"
start() {
echo "Starting $nodeApp"
# Notice that we change the PATH because on reboot
# the PATH does not include the path to node.
# Launching forever with a full path
# does not work unless we set the PATH.
PATH=/usr/local/bin:$PATH
export NODE_ENV=production
#PORT=80
$foreverApp start --pidFile $pidFile -l $logFile -a -d -c "$command" $nodeApp
RETVAL=$?
}
restart() {
echo -n "Restarting $nodeApp"
$foreverApp restart $nodeApp
RETVAL=$?
}
stop() {
echo -n "Shutting down $nodeApp"
$foreverApp stop $nodeApp
RETVAL=$?
}
status() {
echo -n "Status $nodeApp"
$foreverApp list
RETVAL=$?
}
case "$1" in
start)
start
;;
stop)
stop
;;
status)
status
;;
restart)
restart
;;
*)
echo "Usage: {start|stop|status|restart}"
exit 1
;;
esac
exit $RETVAL
5〜11行目にDebianとRedHatそれぞれのコメントがありますので、SysVinitが採用されている多くのディストリビューションで使えそうですね。今回はDebian Wheezyを利用しているので、/etc/init.dにスクリプトを配置し、insservコマンドでサービスの有効化を行います。
$ sudo mv samplenode /etc/init.d/ $ chmod +x /etc/init.d/samplenode $ sudo insserv -d samplenode $ ls /etc/rc?.d/*samplenode /etc/rc0.d/K01samplenode /etc/rc2.d/S17samplenode /etc/rc4.d/S17samplenode /etc/rc6.d/K01samplenode /etc/rc1.d/K01samplenode /etc/rc3.d/S17samplenode /etc/rc5.d/S17samplenode $
ランレベル2〜5でS17samplenodeとなっており、有効になっていることがわかりますね。
いろいろ補足
自動生成されたスクリプトではいくつか不備がありました。フォローしていきます。
nvm環境の場合
nvm環境ではnvmの初期化スクリプトの読み込みが必要ですので、35行目あたりに追加すると良いでしょう。
pidFile="/var/run/samplenode.pid" logFile="/var/run/samplenode.log" # load nvm export NVM_DIR="/home/vagrant/.nvm" [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" # This loads nvm command="node" nodeApp="/home/vagrant/index.js"
statusやstopを動くようにする
生成されたスクリプトではstartは正常に動作するのですが、statusやstopが動きません。これは、foreverのプロセス管理ファイルを格納するディレクトリが設定されていないためのようなので、ディレクトリを作成し、環境変数FOREVER_ROOTをスクリプト内に指定します。
$ sudo mkdir /etc/forever
# set FOREVER_ROOT export FOREVER_ROOT="/etc/forever"
依存サービスの調整
実行するアプリケーションによっては他のサービスに依存する場合があると思います。Debian/UbuntuであればRequired-Start/Required-Stopにサービス名を追加しましょう。例えばアプリケーションからBLEデバイスにアクセスするのであればbluetoothサービスに依存するので、以下のように追記します。
# Required-Start: $remote_fs $syslog bluetooth # Required-Stop: $remote_fs $syslog bluetooth
こうすることで、bluetoothサービスが起動した後でアプリケーションが実行されるよう、/etc/rc?.d/以下のファイルの番号が調整されます。
追記前
$ ls /etc/rc2.d/ README S13rpcbind S16rsyslog S17acpid S17cron S17exim4 S17samplenode S18avahi-daemon S19bootlogs S19saned S20rmnologin S01motd S14nfs-common S16sudo S17atd S17dbus S17rsync S17ssh S18bluetooth S19cups S20rc.local $
追記後
$ sudo insserv -r samplenode $ sudo insserv -d samplenode $ ls /etc/rc2.d/ README S13rpcbind S16rsyslog S17acpid S17cron S17exim4 S17ssh S18bluetooth S19cups S19saned S20rmnologin S01motd S14nfs-common S16sudo S17atd S17dbus S17rsync S18avahi-daemon S19bootlogs S19samplenode S20rc.local $
17番から19番(S18bluetoothの後)になっているのがわかりますね。
RedHat系ディストリビューションの場合は、chkconfig行の起動時の番号(以下の90)と終了時の番号(以下の60)を自分で調整しましょう。
# chkconfig: 2345 90 60
まとめ
いろいろ補足事項はありましたが、さくっとSysVinit互換のスクリプトを生成するinitd-foreverは扱いやすい印象を持ちました。systemdでも同じような話が出てくると思うので、早めに検証/習得しておきたいですね。
![[アップデート] Lambda 関数のランタイムで Node.js 22 が利用可能になったので AWS CDK で設定してみた](https://images.ctfassets.net/ct0aopd36mqt/wp-thumbnail-484d8afca1cbe50513cd4d6738af2960/fa0838fa40f247093d532945fc785e88/aws-lambda)
